home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / news-answers / guidelines next >
Encoding:
Text File  |  1995-07-25  |  41.5 KB  |  937 lines

  1. Subject: *.answers submission guidelines
  2. Newsgroups: news.answers,alt.answers,comp.answers,de.answers,misc.answers,rec.answers,sci.answers,soc.answers,talk.answers
  3. From: news-answers-request@MIT.EDU (the *.answers moderation team)
  4. Date: 8 Nov 1994 23:27:30 GMT
  5.  
  6. Archive-name: news-answers/guidelines
  7. Version: $Id: guidelines,v 1.128 1994/10/16 04:17:57 pschleck Exp $
  8. Posting-Frequency: monthly
  9.  
  10.  
  11. In order to submit an FAQ posting to the news.answers newsgroup (and
  12. to zero or more of the other *.answers newsgroups (alt.answers,
  13. comp.answers, de.answers, misc.answers, rec.answers, sci.answers,
  14. soc.answers, talk.answers) along with it), you should first modify the
  15. header of your posting to conform to the guidelines given below, in 
  16. section I.  Then, you should submit your posting to us using the 
  17. instructions given below, in section II.
  18.  
  19. Once your posting is approved, you will post it directly to
  20. news.answers and other *.answers newsgroups yourself; i.e., after
  21. approval, you no longer have to go through us at all to post.  This is
  22. explained in more detail below.
  23.  
  24. TABLE OF CONTENTS
  25.  
  26. I. Submission guidelines
  27.  A. Why the guidelines?
  28.   1. Appropriateness
  29.   2. Usefulness to people
  30.   3. Automatic archiving
  31.  B. What the guidelines DON'T specify
  32.  C. Required header fields
  33.   1. The normal header
  34.    a. Newsgroups (Required)
  35.    b. Subject (Required)
  36.    c. Followup-To (Required) and Reply-To (Optional)
  37.    d. Supersedes, Expires, References (Optional)
  38.    e. Summary (Optional)
  39.   2. The auxiliary header
  40.    a. Archive-name (Required)
  41.    b. Other archive names (Optional)
  42.    c. Posting-Frequency (Optional)
  43.    d. Last-modified, Version (Optional)
  44.   3. Sample FAQ headers
  45.  D. Posting frequency
  46.  E. Mailing lists for FAQ maintainers
  47.  F. List of Periodic Informational Postings
  48.  G. Article approval
  49.  H. Checklist
  50. II. Submission instructions
  51. III. Once your posting is approved
  52.    A. Transfer an FAQ to a new maintainer
  53.    B. Change an FAQ's posting frequency
  54.    C. Change an FAQ's header(s)
  55.       1. Subject line
  56.       2. Newsgroups line
  57.       3. From line, without changing maintainers
  58.       4. Archive-name line
  59.       5. Followup-To line
  60.       6. Other headers
  61.    D. Add postings to or delete postings from an FAQ
  62.       1. Split up a single-part FAQ
  63.       2. Add a new part to a FAQ which already has multiple parts
  64.       3. Delete a part from a multi-part FAQ
  65.       4. Add a diff posting
  66.       5. Terminate an FAQ (i.e., stop posting it forever)
  67.    E. Create a new FAQ
  68. IV. This posting
  69. V. Getting the "List of Periodic Informational Postings"
  70.  
  71. ======================================================================
  72.  
  73.  
  74. I. Submission guidelines
  75.  
  76.  A. Why the guidelines?
  77.  
  78.     There are three main reasons for the guidelines:
  79.  
  80.   1. Appropriateness
  81.  
  82.      Only periodic informational postings that are intended to be read
  83.      by people belong in *.answers.  The guidelines are meant to
  84.      prevent other types of postings, including discussion of periodic
  85.      informational postings, from appearing in the group.
  86.  
  87.   2. Usefulness to people
  88.  
  89.      The newsgroup should be as useful as possible to the people who
  90.      read it.  Requirements such as effective "Subject:" and
  91.      "Summary:" lines (see below) further this goal.
  92.  
  93.   3. Automatic archiving
  94.  
  95.      One of the main points for having *.answers newsgroups is that
  96.      they can be archived automatically in order to build up a
  97.      database of periodic informational postings.  Requirements such
  98.      as the "Archive-name:" line further that goal.
  99.  
  100.  B. What the guidelines DON'T specify
  101.  
  102.     These guidelines DO NOT specify a specific, required format for
  103.     the bodies of FAQ postings.  Postings in *.answers are not
  104.     required to adhere to "Digest Message Format" format (Internet RFC
  105.     1153), or MIME (RFC 1341), or HTML, or SGML, or any other text
  106.     format, standard or otherwise.
  107.  
  108.     This omission is intentional.  Forcing all *.answers postings to
  109.     adhere to a specific format would dissuade many FAQ maintainers
  110.     from submitting their postings to *.answers.  Such a result would
  111.     be in direct contradiction to the chartered purpose of *.answers;
  112.     therefore, FAQ maintainers are free to choose whatever format they
  113.     want (assuming that it is human-readable) for the bodies of their
  114.     postings.
  115.  
  116.     These guidelines also DO NOT specify lower or upper limits for the
  117.     size of an acceptable FAQ posting.  However, a pragmatic lower limit
  118.     is set by the requirement that the articles be useful to people.  As
  119.     for a pragmatic upper limit, FAQ maintainers may wish to consider
  120.     that some part of their audience may not be able to access very
  121.     large articles at their sites due to intermediary software problems
  122.     (64KB is a common magic number), so postings larger than that may
  123.     not be able to be read by many people.
  124.  
  125.  C. Required header fields
  126.  
  127.     There are two "headers" in a *.answers posting.  The first is
  128.     the normal header that any article posted to the USENET has.  The
  129.     second header, the "auxiliary header," is separated from the first
  130.     by one or more blank lines.  As far as the News software is
  131.     concerned, the auxiliary header is just part of the body of the
  132.     article; however, *.answers requires some information in it.
  133.  
  134.     The requirements for each of the two headers are discussed in
  135.     detail below.  Required headers are marked with "(Required)",
  136.     while optional ones are marked with "(Optional)".
  137.  
  138.     You may wish to refer to section 3 for a full set of sample
  139.     headers while reading the detailed descriptions and explanations
  140.     of the required and optional headers.  The headers at the very top
  141.     of this document can also serve as a sample.
  142.  
  143.   1. The normal header
  144.  
  145.    a. Newsgroups (Required)
  146.  
  147.       We need to know exactly what will appear in the Newsgroups line
  148.       of the posting.
  149.  
  150.       In addition to news.answers, your posting should be cross-posted
  151.       to the other *.answers newsgroups of hierarchies in which it is
  152.       posted.  For example, a posting that is normally posted in both
  153.       rec.music.makers.synth and comp.sys.ibm.pc.soundcard should be
  154.       posted to both rec.answers and comp.answers in addition to
  155.       news.answers.  Note that postings to any of the *.answers
  156.       newsgroups MUST be posted in news.answers, regardless of what
  157.       other *.answers newsgroups they also appear in.
  158.  
  159.       There is one exception to the above rule of always crossposting
  160.       to the corresponding *.answers groups: postings to newsgroups
  161.       which go to a non-international hierarchy in a different
  162.       language.  Such an article should not go into the corresponding
  163.       *.answers group.  At present, the only such case is de.answers,
  164.       which is for German-language periodic informational postings
  165.       only.  For example, an English-language FAQ may be posted to a
  166.       de.* group if the maintainer feels it is useful there, but
  167.       should not be not cross-posted to de.answers.
  168.  
  169.       Although the order of newsgroups on the line is not important
  170.       from the point of view of the news software, we prefer to have
  171.       news.answers listed last.  The other *.answers newsgroups should
  172.       be listed directly before news.answers.  Listing the primary
  173.       newsgroup(s) first improves the accuracy of newsgroup volume
  174.       statistics, provides better key information for index lists and
  175.       catalogues, and minimizes accidental postings to the *.answers
  176.       newsgroups from buggy newsreaders.
  177.  
  178.       Example:
  179.  
  180.        Newsgroups: comp.sys.foo,comp.answers,news.answers
  181.  
  182.       Note that your Newsgroups line should NOT contain only *.answers
  183.       groups.  FAQ postings should be cross-posted to *.answers from
  184.       their home newsgroup(s), rather than being posted separately to
  185.       *.answers.
  186.  
  187.       However, if you get approval for *.answers cross-posting in the
  188.       middle of your "posting cycle," and you do not wish to wait
  189.       until the next scheduled posting time to cross-post to
  190.       *.answers, then you can post your FAQ only to *.answers.  If you
  191.       choose to do this, please make sure to let us know you are going
  192.       to, and please do not do it more than once.
  193.  
  194.    b. Subject (Required)
  195.  
  196.       The subject line of your posting should have some meaning
  197.       outside of its home newsgroup(s).  For example, instead of just
  198.       "FAQ," you might have "<x> FAQ", where "<x>" is the name of the
  199.       newsgroup or the topic being discussed.
  200.  
  201.       Furthermore, important information should appear near the
  202.       beginning of the subject line, so that news readers that display
  203.       article summaries don't cut off the important information.  For
  204.       example, instead of "Frequently Asked Questions about <x>," use
  205.       "<x> Frequently asked Questions."
  206.  
  207.       Please note that most archivers treat the subject as 
  208.       case-sensitive -- it must always be capitalized in exactly the 
  209.       same way.
  210.  
  211.       For postings which are being split into multiple parts, you
  212.       should indicate in each posting's Subject line which part that
  213.       particular posting is, and how many parts total there are.  For
  214.       this purpose, simple Arabic numerals are prefered over Roman
  215.       numerals because Arabic numerals are more easily sorted and
  216.       manipulated by software. (See section III.D for more information
  217.       on splitting existing FAQs.)
  218.  
  219.       Example:
  220.  
  221.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 1/2
  222.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  223.  
  224.    c. Followup-To (Required) and Reply-To (Optional)
  225.  
  226.       Your posting must have a "Followup-To:" line in the header that
  227.       directs followups to somewhere other than *.answers.  You may
  228.       choose to direct followups back to the home newsgroup(s) of the
  229.       FAQ, or to direct followups to the author of the FAQ, in which
  230.       case "Followup-To: poster" is sufficient.  That means that you
  231.       actually put the word "poster" there, as specified in the RFC
  232.       which describes the format of Usenet postings.  Do NOT put an
  233.       E-mail address in the "Followup-To:" field.
  234.  
  235.       If you forget the "Followup-To:" and we get mailed followups to
  236.       your FAQ, we're going to get peeved at you.
  237.  
  238.       Furthermore, your posting must have a valid E-mail reply address
  239.       in the header, either in the "From:" field, or if not in "From:"
  240.       then in "Reply-To:".
  241.  
  242.       Example:
  243.  
  244.        From: guru@foosys.com (Joe R. Programmer)
  245.        Followup-To: comp.sys.foo
  246.        Reply-To: faq-mail@foosys.com (FAQ Comments address)
  247.  
  248.       In this example, "guru" apparently wants mail about the FAQ to
  249.       go to a different address than the rest of his mail.  We've
  250.       shown the "From:" header, because the version of the FAQ that
  251.       you forward to us should show the "From:" header just as it will
  252.       appear when the article is actually posted.
  253.  
  254.    d. Supersedes, Expires, References (Optional)
  255.  
  256.       It is a good idea to use "Supersedes:" and "Expires:" header
  257.       lines to make sure that each version of your FAQ stays around
  258.       until the next time it is posted.  A useful tool for this is the
  259.       Perl FAQ poster written by Jonathan Kamens.  It is available
  260.       from rtfm.mit.edu, via anonymous ftp in the file
  261.       /pub/post_faq/post_faq.shar, or via mail server (send mail to
  262.       mail-server@rtfm.mit.edu with "send post_faq/post_faq.shar" in
  263.       the body).
  264.  
  265.       Post_faq takes an article with its static headers (i.e., the
  266.       headers that don't change each time the article is posted)
  267.       included, adds dynamic headers to it, and posts the article.
  268.       Another utility, Ian Kluft's auto-faq package (which is also
  269.       written in Perl) provides more functionality, including
  270.       automatic building and insertion of all headers.  If you are
  271.       looking for something with a high level of automation to
  272.       assist you in your FAQ maintenance and posting, you might want
  273.       to try auto-faq instead of post_faq.  The latest version is 3.2
  274.       and is available via anonymous FTP from charon.amdahl.com in
  275.       files:
  276.  
  277.       /pub/faq/auto-faq32.part1.gz
  278.       /pub/faq/auto-faq32.part2.gz
  279.       /pub/faq/auto-faq32.part3.gz
  280.  
  281.       (Note: It's strongly encouraged that you use version 3.x or
  282.       later as previous versions have an identified bug in 
  283.       formatting dates, such as in the Expires header.)  For further
  284.       assistance, send E-mail to auto-faq-help@kluft.com.
  285.  
  286.       Furthermore, if you are posting a multi-part FAQ posting or a
  287.       series of related FAQ postings, it is a good idea to add a
  288.       "References:" line to all of the postings except the first one,
  289.       making the contents of that line the Message-ID of the first
  290.       posting in the series.  If you do this, then people who use
  291.       threaded news readers will be able to manipulate the entire
  292.       series as a single thread, including (for example) killing the
  293.       entire thread if they're not interested or saving the entire
  294.       thread to a file with one command.  The perl FAQ posting tools
  295.       mentioned above support an option for doing this.
  296.  
  297.       Example:
  298.  
  299.        Expires: Fri, 1 May 1992 00:00:00 GMT
  300.        Supersedes: <foo-faq/part2_701650000@foosys.com>
  301.        References: <foo-faq/part1_702000000@foosys.com>
  302.  
  303.       The date in the "Expires:" header should be far enough into the
  304.       future that a new version of the FAQ will be posted before the
  305.       one you're posting now expires.  We've shown all three headers in the
  306.       format the post_faq script would use. 
  307.  
  308.    e. Summary (Optional)
  309.  
  310.       You are encouraged to put a summary of the contents of your
  311.       article in the Summary field of the header.  Try to describe
  312.       what your FAQ discusses, and aim your description at someone who
  313.       may not actually be directly interested in the topic covered by
  314.       your FAQ.  There have been discussions about using the Summary
  315.       fields of the FAQ postings in *.answers to construct a short
  316.       "catalog" of the information available through news.answers, so
  317.       think of the Summary field as a "catalog entry" for your FAQ.
  318.  
  319.       Note that header fields (except for the Newsgroups field) are
  320.       allowed to span multiple lines, as long as the continuation
  321.       lines after the first start with whitespace (at least one space
  322.       or tab character).
  323.  
  324.       Example:
  325.  
  326.        Summary: This posting contains a list of Frequently Asked
  327.                Questions (and their answers) about Foo computers.  It
  328.                should be read by anyone who wishes to post to the
  329.                comp.sys.foo newsgroup.
  330.  
  331.   2. The auxiliary header
  332.  
  333.      The auxiliary header looks like the main message header (i.e.
  334.      "Field-name: field-value"), but is separated from the main
  335.      message header by a blank line, as well as followed by a blank
  336.      line separating it from the rest of the body of the message.
  337.  
  338.      The auxiliary header of this posting is:
  339.  
  340.      Archive-name: news-answers/guidelines
  341.      Version: $Id: guidelines,v 1.128 1994/10/16 04:17:57 pschleck Exp $
  342.      Posting-Frequency: monthly
  343.  
  344.    a. Archive-name (Required)
  345.  
  346.       In order to be cross-posted into *.answers, your posting must
  347.       include an auxiliary header with an "Archive-name:" field.
  348.  
  349.       The purpose of the archive name is two-fold.  First of all, it
  350.       specifies where the FAQ should be stored in archives of the
  351.       *.answers newsgroups.  Second, it should give people, even
  352.       people who do not read the home newsgroup(s) of the FAQ, a pretty
  353.       good idea of what's in it.  Therefore, abbreviations which will
  354.       only be recognized by people already familiar with the topic
  355.       covered by the FAQ should be avoided if possible.
  356.  
  357.       The archive name should be composed of one or more one-word
  358.       (i.e., no spaces) components, separated by slashes.  Each
  359.       component should be 14 characters or less in length, if
  360.       possible, but this is not a strict requirement; if 14 characters
  361.       isn't enough, then each component should be unique in the first
  362.       14 characters (i.e., two archive names should never be identical
  363.       after their components are all truncated to 14 characters).
  364.       Avoid periods in the archive name, because some operating
  365.       systems choke on them; if you must have word separators, use
  366.       hyphens or underscores rather than periods.  Please note that
  367.       most archivers treat the archive name as case-sensitive -- it 
  368.       must always be capitalized in exactly the same way.
  369.  
  370.       The archive namespace is hierarchical; for example, there are a
  371.       number of lists of bookstores in the "books/stores" directory of
  372.       the namespace, and all of their archive names start with
  373.       "books/stores/".  Avoid using slashes in your archive name
  374.       unless you are taking advantage of the hierarchical nature of
  375.       the namespace, i.e., unless you have multiple related FAQ
  376.       postings which should appear in a single directory in the
  377.       archive namespace.
  378.  
  379.       Multi-part FAQs should be named "name/part1", "name/part2", etc.
  380.       Alternatively, if the parts of the FAQ are split by topic rather
  381.       than by size, then you can use short topic names rather than
  382.       "part1", "part2", etc.
  383.  
  384.       If you post a diff for your FAQ, it should be named "name/diff".
  385.       If you post multiple diffs for a multi-part FAQ, they should be
  386.       named "name/diff1", "name/diff2", etc. (if you want to use just
  387.       one diff for a multi-part FAQ, you can just use "name/diff" as
  388.       its name).  If you post a diff to a one-part posting, then the
  389.       original FAQ should be named "name/part1" (or "name/faq", or
  390.       whatever else you think is appropriate, as long as we approve
  391.       it) and the diff should be named "name/diff".
  392.  
  393.       Consider these examples:
  394.  
  395.         Topic                                   Archive name(s)
  396.         -----------------------------------     ------------------------------
  397.         comp.ai FAQ                             ai-faq/part1
  398.                                                 ai-faq/part2
  399.                                                 ai-faq/part3
  400.         rec.travel.air FAQs, various topics     air-travel/bucket-shops
  401.                                                 air-travel/cheap-tickets/part1
  402.                                                 air-travel/cheap-tickets/part2
  403.                                                 air-travel/faq
  404.                                                 air-travel/jetlag-prevention
  405.                                                 air-travel/na-airport-codes
  406.                                                 air-travel/world-airport-codes
  407.         soc.culture.esperanto FAQ               esperanto-faq
  408.  
  409.       Please pick the archive name that you would like to use for your
  410.       posting, and include the "Archive-name:" line with that archive
  411.       name in it, when submitting to *.answers.  If there is some
  412.       problem with it, or if we would like to suggest an alternate
  413.       name, we will let you know.
  414.  
  415.       Example:
  416.  
  417.        Archive-name: foo-faq/part2
  418.  
  419.       If your posting already has an "Archive-name:" line which is not
  420.       a valid *.answers archive name and you do not want to change it,
  421.       or if you want the "Archive-name:" line you add to contain the
  422.       name of a file in your own archives rather than in the
  423.       news.answers archives, you can use a
  424.       "News-answers-archive-name:" header line instead.
  425.  
  426.    b. Other archive names (Optional)
  427.  
  428.       The software which builds the FAQ archive on rtfm.mit.edu (see
  429.       the "Introduction to the *.answers newsgroups" posting for more
  430.       information about it) automatically uses the "Archive-name:"
  431.       line to determine the file name in which to save an FAQ, when
  432.       saving it in any of the "answers" newsgroups (news.answers,
  433.       rec.aviation.answers, etc.).
  434.  
  435.       Furthermore, if you have a field of the form
  436.       "Newsgroup-name-archive-name: name" in your FAQ's auxiliary
  437.       header (see the example below), the specified archive name will
  438.       be used to save in the specified newsgroup.  Such a
  439.       newsgroup-specific archive name overrides any generic
  440.       "Archive-name:" line.
  441.  
  442.       When an archive name for an FAQ cannot be determined in either
  443.       of the ways mentioned above, the Subject line of the posting
  444.       (with some minor modifications) is used as its file name.
  445.  
  446.       For example, if you have this in your normal header:
  447.  
  448.        Newsgroups: comp.foo,comp.bar,comp.answers,news.answers
  449.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  450.  
  451.       and this in your auxiliary header:
  452.  
  453.        Archive-name: foo-faq/part2
  454.        Comp-bar-archive-name: bar-faq/part2
  455.  
  456.       then the posting will be saved as "foo-faq/part2" in comp.answers
  457.       and news.answers (because they are both "answers" newsgroups and
  458.       will use the Archive-name line), as "bar-faq/part2" in comp.bar,
  459.       and as "comp.sys.foo_Frequently_Asked_Questions_(FAQ),_Part_2/2"
  460.       in comp.foo.
  461.  
  462.       If you do decide to specify additional archive names in your
  463.       posting, please obey the guidelines for archive names given
  464.       above.
  465.  
  466.    c. Posting-Frequency (Optional)
  467.  
  468.       A "Posting-Frequency" field in the auxiliary header can give
  469.       the reader a good idea of how often your FAQ is posted, for example
  470.       "every 14 days" or "monthly" (see section D, below).
  471.  
  472.       Example:
  473.  
  474.        Posting-Frequency: monthly
  475.  
  476.       If you specify this field, it will be automatically copied into
  477.       the "List of Periodic Informational Postings".
  478.  
  479.    d. Last-modified, Version (Optional)
  480.  
  481.       You can have other fields in the auxiliary header, if you want.
  482.       Two common ones are "Last-modified:" and "Version:". You may put
  483.       any text you want in these fields, in any format you wish.
  484.  
  485.       Example:
  486.  
  487.        Last-modified: 1992/03/25
  488.        Version: 2.5
  489.       
  490.   3. Sample FAQ headers
  491.  
  492.      Putting together the examples we"ve given above, here is what the
  493.      headers of part 2 of your posting (or, at least, the ones you
  494.      submit to us) might look like:
  495.  
  496.      From: guru@foosys.com (Joe R. Programmer)
  497.      Newsgroups: comp.sys.foo,comp.answers,news.answers
  498.      Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  499.      Followup-To: comp.sys.foo
  500.      Reply-To: faq-mail@foosys.com (FAQ Comments address)
  501.      Summary: This posting contains a list of Frequently Asked
  502.              Questions (and their answers) about Foo computers.  It
  503.              should be read by anyone who wishes to post to the
  504.              comp.sys.foo newsgroup.
  505.      Expires: Fri, 1 May 1992 00:00:00 GMT
  506.      Supersedes: <foo-faq/part2_701650000@foosys.com>
  507.      References: <foo-faq/part1_702000000@foosys.com>
  508.  
  509.      Archive-name: foo-faq/part2
  510.      Posting-Frequency: monthly
  511.      Last-modified: 1992/03/25
  512.      Version: 2.5
  513.  
  514.      Note that the blank line separating the normal header from the
  515.      auxiliary header must be completely blank, i.e., no tabs or
  516.      spaces, and that there must also be one or more completely blank
  517.      lines after the auxiliary header.
  518.  
  519.      Of course, you can include in the posting header any of the other
  520.      standard USENET header fields that have not been discussed here.
  521.  
  522.  D. Posting frequency
  523.  
  524.     The frequency at which you choose to post your FAQ is left to your
  525.     discretion.  Some FAQ maintainers find that a monthly posting,
  526.     with an Expires header to prevent each posting from going away
  527.     before its replacement is posted, is sufficient.  Some other
  528.     newsgroups are so busy that a weekly posting of the FAQ is needed.
  529.     Another possibility is to post the complete FAQ relatively
  530.     infrequently, while posting a shorter pointer to it (e.g.,
  531.     providing instructions for getting it from archives) more
  532.     frequently.
  533.  
  534.     If you choose to post your FAQ more frequently than once per
  535.     month, you might want to consider not cross-posting it to
  536.     *.answers every time you post.  Although it may be necessary to
  537.     post the FAQ in its home newsgroup(s) often, it is probably not
  538.     necessary to post it in *.answers as frequently.
  539.  
  540.     Note, however, that if you do this, you can't use Supersedes every
  541.     time you post your FAQ, since a posting in just the FAQ's home
  542.     newsgroup(s) should not supersede the posting in both the home
  543.     newsgroup(s) and *.answers.  Therefore, unless you're willing to have
  544.     two copies of your FAQ in your home newsgroup(s) at all times, you
  545.     should always cross-post to *.answers (or use the system mentioned
  546.     above, cross-posting the full FAQ to *.answers and a more frequent
  547.     pointer posting just in its home newsgroup[s]).
  548.  
  549.     When submitting your FAQ, please be sure to let us know the
  550.     frequency at which you intend to post it to its home newsgroup(s), as
  551.     well as the frequency at which you intend to cross-post it to
  552.     *.answers (if different).  The best way for this is to put this
  553.     information into the "Posting-Frequency" field of the auxiliary
  554.     header.
  555.  
  556.  E. Mailing lists for FAQ maintainers
  557.  
  558.     Maintainers of FAQs are strongly urged to join the faq-maintainers
  559.     mailing list, which is used for discussion about the *.answers
  560.     newsgroups and the maintenance of USENET FAQs.  Anyone is allowed
  561.     to subscribe to these mailing lists -- in particular, you may
  562.     subscribe before you even submit your FAQ to us.
  563.  
  564.     If you don't want to be on the discussion list, you may wish to
  565.     join the faq-maintainers-announce list, which will be used only
  566.     for announcements, instead.  Note that subscribers to the
  567.     faq-maintainers list automatically receive all messages sent to
  568.     faq-maintainers-announce.
  569.  
  570.     Traffic on faq-maintainers tends to come in bursts -- it averages
  571.     three to four messages per week, but during a burst there may be as
  572.     many as several dozen messages in a single day, and in between such
  573.     bursts, there may be weeks of no messages at all.
  574.  
  575.     Traffic on faq-maintainers-announce is very low (it is not unheard
  576.     of for six months to pass with no messages sent to the list).
  577.  
  578.     When submitting your FAQ, make sure to let us know whether or not
  579.     you want to be on one of the lists, or if you are already
  580.     subscribed. (If you do not, we will ask you if you wish to
  581.     subscribe, so you might as well tell us. :) It is best to let us
  582.     know in a separate piece of email, rather than including it in the
  583.     body of your FAQ when you first submit it, lest we not notice it
  584.     in the body of your FAQ; also, please make clear you are asking to
  585.     subscribe to one of these mailing lists (the *.answers moderators
  586.     sometimes get random "subscribe" messages from people hoping they
  587.     can get us to feed them news.answers via email).  All other
  588.     administrative requests related directly to the faq-maintainers or
  589.     faq-maintainers-announce mailing lists should be sent to
  590.     faq-maintainers-request@mit.edu.
  591.  
  592.  F. List of Periodic Informational Postings
  593.  
  594.     Unless you tell us otherwise, we will add any postings submitted
  595.     to *.answers to the "List of Periodic Informational Postings"
  596.     (LoPIP) articles which appear in news.answers and news.lists.
  597.  
  598.     If you do not have copies of the LoPIP postings and would like to
  599.     get them, to see what they're like or to check if your FAQ is
  600.     already listed, see the instructions at the end of this message.
  601.  
  602.  G. Article approval
  603.  
  604.     Once all of the other issues listed in this posting are resolved,
  605.     you will be given approval to cross-post your FAQ to *.answers.
  606.     You will have to indicate in the header of your posting that such
  607.     approval has been given, or the posting will be mailed to us
  608.     instead of posted.
  609.  
  610.     Note that we are intentionally being somewhat vague about what
  611.     this entails.  When we approve your posting for *.answers, we will
  612.     provide more specific instructions.
  613.  
  614.  H. Checklist
  615.  
  616.     Following is a checklist for your *.answers submission.  Please
  617.     go through all the questions; if you answer "no" to any of
  618.     them, look at the relevant section of this article again, and
  619.     correct your submission accordingly.
  620.  
  621.         Does the posting have a message header?
  622.         Does the posting have a Newsgroups line?
  623.         Does the Newsgroups line contain at least one newsgroup other
  624.                 than the *.answers newsgroups?
  625.         Does the Newsgroups line contain news.answers?
  626.         Are the *.answers newsgroups listed last on the Newsgroups
  627.                 line (with news.answers last of all)?
  628.         Does the Newsgroups line contain all relevant *.answers
  629.                 newsgroups?
  630.         Does the Newsgroups line contain only relevant *.answers
  631.                 newsgroups?
  632.         Does the posting have a Subject line?
  633.         Is the Subject line informative?
  634.         Is important information on the Subject line near the
  635.                 beginning of the line?
  636.         Does the posting have a Followup-To line?
  637.         Does the Followup-To line omit all the *.answers newsgroups?
  638.         Does the posting have a From or Reply-To line with a valid
  639.                 email address?
  640.         Does the posting have an Archive-name line?
  641.         Is the auxiliary header separated from the body of your
  642.                 posting by a blank line?
  643.         Is the auxiliary header separated from the main header by a
  644.                 blank line?
  645.         Is the Archive-name line valid?
  646.         Have you told us the frequency of your posting?
  647.         Have you told us whether you want to be on faq-maintainers or
  648.                 faq-maintainers-announce?
  649.  
  650. II. Submission instructions
  651.  
  652.    If you have a posting which you wish to submit to *.answers, you
  653.    should first read the guidelines listed above and modify your
  654.    posting to conform to them.  Then, you should submit it by posting
  655.    it to the news.answers newsgroup, assuming that the software on the
  656.    poster's site works properly and will forward the posting to the
  657.    news.answers moderator, or by mailing it to the news.answers
  658.    submission address, news-answers@MIT.EDU.  ONLY SUBMISSIONS SHOULD
  659.    BE MAILED TO THAT ADDRESS.  If there is some commentary or
  660.    explanation that needs to be made, it should be mailed in a
  661.    separate message to news-answers-request@MIT.EDU, which is the
  662.    moderator contact address for any *.answers-related business.
  663.  
  664.    If you post the FAQ to both *.answers and one or more other
  665.    moderated groups, you need separate approval from each of the
  666.    moderators.  Wait for approval from each of them (including us)
  667.    before actually posting.  In this case, you should send in the
  668.    FAQ to us via e-mail, because the submission will be sent via
  669.    e-mail to the first moderated group which appears in the
  670.    Newsgroup line.
  671.  
  672.    Please submit the FAQ in a form as close as possible to how it
  673.    appears when you post it normally.  This means that you should
  674.    include a complete header, with at the very least the Subject line
  675.    you normally use.  We very much prefer you actually posting the
  676.    message to *.answers as you would post it normally, including the
  677.    cross-posted newsgroups, but omitting the moderation approval
  678.    header line that would cause the article to actually be posted
  679.    rather than mailed to us; this way, we will get to see exactly how
  680.    the article will look when it is actually posted in *.answers.
  681.    Also, if your FAQ does not say somewhere near the top how often it
  682.    is posted, then please let us know the frequency in separate
  683.    E-mail.
  684.  
  685.    Note that if you do not indicate moderator approval in the header
  686.    of your posting, it will NOT be posted to any newsgroup, even if
  687.    you list other newsgroups on the Newsgroups line besides *.answers
  688.    groups.  Therefore, you CAN and SHOULD place all Newsgroups to
  689.    which you intend to post in the Newsgroups line, in the order you
  690.    intend them to be in when you post.
  691.  
  692.    We will respond, by agreeing that the FAQ belongs in *.answers
  693.    as-is, or by asking you to make minor modifications to it in order
  694.    to make it acceptable, or by rejecting it as inappropriate for
  695.    *.answers.  If you are asked to make modifications, please do so
  696.    and resubmit the posting to us just as you did the first time.
  697.  
  698.    We are all volunteers, doing *.answers moderation in our spare
  699.    time.  Therefore, we can't always process submissions and other
  700.    *.answers-related correspondence immediately.  Please don't
  701.    write to us asking whether we received your submission until at
  702.    least a week after you submitted it.
  703.  
  704.    Note that because of the potential length of delays involved in
  705.    getting your postings approved, you may wish to continue posting
  706.    your FAQ in its home newsgroup(s) in the meantime.
  707.  
  708.    Once an FAQ has been approved for *.answers, you will post it
  709.    directly to the group yourself, by indicating in the header of the
  710.    message that it was approved by the *.answers moderator, as
  711.    described above.
  712.  
  713.    If possible, try to avoid posting your FAQ at a "predictable"
  714.    time.  For example, if you have decided to post it monthly, don't
  715.    automatically decide to post it on the first of every month.  This
  716.    causes a flood of FAQs in *.answers (and on the net in general) at
  717.    certain times of months, and this flood is big enough to overwhelm
  718.    some smaller sites and many readers of *.answers.  Therefore,
  719.    rather than picking the "obvious" time to post, pick some other,
  720.    random time during the month to do your posting.
  721.  
  722.    If you have trouble posting your FAQ once it has been approved,
  723.    because your site won't let you post to a moderated newsgroup,
  724.    because you don't have good posting access, or because of any other
  725.    reason, feel free to get in touch with us and we'll try to help.
  726.    Alternatively, you can use the FAQ server which we run to help
  727.    solve such problems; you mail your FAQ or FAQs to it, and it posts
  728.    them periodically automatically.  For more information about the
  729.    FAQ server, send mail to faq-server@rtfm.mit.edu with "help"
  730.    (without the quotes) in the Subject of your message.
  731.  
  732.  
  733. III. Once your posting is approved
  734.  
  735.    The following is a list of some situations which might occur after
  736.    your FAQ has been approved for *.answers, and what you need to do
  737.    for each one.
  738.  
  739.    Note that if none of these situations occur, the *.answers
  740.    moderators will expect you to continue posting your FAQ regularly,
  741.    and there is no need to resubmit your FAQ just because you are
  742.    regularly revising its *CONTENTS*.
  743.  
  744.    A. Transfer an FAQ to a new maintainer
  745.  
  746.       The old maintainer should inform news-answers-request@mit.edu of
  747.       the change in maintainers.  The new maintainer should read this
  748.       document (i.e., the "*.answers submission guidelines") and
  749.       inform news-answers-request@mit.edu that he has done so.
  750.       Furthermore, the new maintainer should resubmit the FAQ even if
  751.       there are no header changes planned except for the From and/or
  752.       Reply-To lines, since we'd like to confirm that the new
  753.       maintainer's news server doesn't munge headers.  The new
  754.       maintainer should wait for reapproval before posting.
  755.  
  756.    B. Change an FAQ's posting frequency
  757.  
  758.       Inform news-answers-request@mit.edu of the new frequency, unless
  759.       you have a "Posting-Frequency" field in your auxiliary header;
  760.       in that case, just change that field.  You do not need to await
  761.       reapproval from us.
  762.  
  763.    C. Change an FAQ's header(s)
  764.  
  765.       1. Subject line
  766.  
  767.          Inform news-answers-request@mit.edu of the new Subject line,
  768.          or resubmit the entire FAQ to news-answers@mit.edu; in either
  769.          case, wait for reapproval before posting.
  770.  
  771.       2. Newsgroups line
  772.  
  773.          Inform news-answers-request@mit.edu of the new Newsgroups
  774.          line, or resubmit the entire FAQ to news-answers@mit.edu; in
  775.          either case, wait for reapproval before posting.
  776.  
  777.       3. From line, WITHOUT CHANGING MAINTAINERS
  778.  
  779.          If the From line of your post changes, inform
  780.          news-answers-request@mit.edu of the new address before
  781.          posting.  Make sure you specify whether the change is
  782.          permanent, or is a one-time exception.
  783.  
  784.          You do not need to wait for reapproval if you are not
  785.          changing any of the other headers on your post, and are sure
  786.          that the posting software at your new site will produce
  787.          correct headers.
  788.          
  789.       4. Archive-name line
  790.  
  791.          Inform news-answers-request@mit.edu and wait for reapproval
  792.          before posting.
  793.  
  794.       5. Followup-To line
  795.  
  796.          As long as it exists and doesn't contain any *.answers
  797.          newsgroups in it, you don't have to do anything if you change
  798.          its contents.
  799.  
  800.       6. Other headers
  801.  
  802.          As long as you don't change the overall structure of your
  803.          headers (e.g., make sure you keep an auxiliary header with
  804.          the Archive-name line in it), you don't have to do anything
  805.          about changes to other headers.
  806.  
  807.    D. Add postings to or delete postings from an FAQ
  808.  
  809.       1. Split up a single-part FAQ
  810.  
  811.          Submit all the parts to news-answers@mit.edu, with archive names
  812.          in the format "foo-faq/part1", "foo-faq/part2", etc.  Wait for
  813.          approval before posting.
  814.  
  815.       2. Add a new part to a FAQ which already has multiple parts
  816.  
  817.          Submit the new part to news-answers@mit.edu, or inform
  818.          news-answers-request@mit.edu if the new part's headers are
  819.          consistent with the other parts (e.g., if your Subject lines
  820.          are in the form "foo FAQ part * of *" and your archive names
  821.          look like "foo-faq/part*", and you add a new part which looks
  822.          just like the others except for a new part number, you don't
  823.          have to resubmit the new part or resubmit all the other parts
  824.          because you changed the "of *" number in their Subject
  825.          lines).  Either way, wait for approval before posting with
  826.          the new part or parts.
  827.  
  828.       3. Delete a part from a multi-part FAQ
  829.  
  830.          Inform news-answers-request@mit.edu.  Wait for approval
  831.          before posting.
  832.  
  833.       4. Add a diff posting
  834.  
  835.          Submit it to news-answers@mit.edu.  If you already have a
  836.          multi-part FAQ, choose the archive name to be consistent with
  837.          the other ones. If your archive names look like "foo-faq/part*",
  838.          the diff posting should have the archive name "foo-faq/diff".  If
  839.          your FAQ had only one part before the change, add "/part1" to the
  840.          archive name (e.g. "foo-faq/part1"), and submit both the FAQ and
  841.          the diff posting.  Wait for reapproval before posting the diff.
  842.  
  843.       5. Terminate an FAQ (i.e., stop posting it forever)
  844.  
  845.          Inform news-answers-request@mit.edu.
  846.  
  847.    E. Create a new FAQ
  848.  
  849.       Submit it to *.answers following the guidelines in sections I
  850.       and II above, just like you submitted your previous FAQ(s).
  851.  
  852.  
  853. IV. This posting
  854.  
  855.    Comments about, suggestions about or corrections to this posting
  856.    are welcomed.  If you would like to ask us to change this posting
  857.    in some way, the method we appreciate most is for you to actually
  858.    make the desired modifications to a copy of the posting, and then
  859.    to send us the modified posting, or a context diff between the
  860.    posted version and your modified version (if you do the latter,
  861.    make sure to include in your mail the "Version:" line from the
  862.    posted version).  Submitting changes in this way makes dealing with
  863.    them easier for us and helps to avoid misunderstandings about what
  864.    you are suggesting.
  865.  
  866.    The following people provided feedback and helped to make this
  867.    posting more readable and useful:
  868.  
  869.      Stan Brown <brown@NCoast.ORG>
  870.      L. Detweiler <ld231782@longs.lance.colostate.edu>
  871.      Aydin Edguer <edguer@alpha.CES.CWRU.Edu>
  872.      Mark Eckenwiler <eck@panix.com>
  873.      Tom_Lane@G.GP.CS.CMU.EDU
  874.      Cindy Tittle Moore <tittle@ics.uci.edu> 
  875.      Steven D. Ourada <sourada@iastate.edu>
  876.      Edward Reid <ed@titipu.resun.com>
  877.      Ken Shirriff <shirriff@sprite.Berkeley.EDU>
  878.      Dan Tilque <dant@logos.WR.TEK.COM>
  879.      Bill Wohler <wohler@newt.com>
  880.      Lars Aas <larsa@colargol.edb.tih.no>
  881.  
  882.  
  883. V. Getting the "List of Periodic Informational Postings"
  884.  
  885.    There are nine "List of Periodic Informational Postings"
  886.    postings:
  887.  
  888.     Subject: List of Periodic Informational Postings, Part 1/9
  889.     Subject: List of Periodic Informational Postings, Part 2/9
  890.     Subject: List of Periodic Informational Postings, Part 3/9
  891.     Subject: List of Periodic Informational Postings, Part 4/9
  892.     Subject: List of Periodic Informational Postings, Part 5/9
  893.     Subject: List of Periodic Informational Postings, Part 6/9
  894.     Subject: List of Periodic Informational Postings, Part 7/9
  895.     Subject: List of Periodic Informational Postings, Part 8/9
  896.     Subject: List of Periodic Informational Postings, Part 9/9
  897.     Newsgroups: news.lists,news.answers
  898.  
  899.    They are available in the indicated USENET newsgroups, or via
  900.    anonymous ftp from rtfm.mit.edu (18.181.0.24) in the files:
  901.  
  902.     /pub/usenet/news.answers/periodic-postings/part1
  903.     /pub/usenet/news.answers/periodic-postings/part2
  904.     /pub/usenet/news.answers/periodic-postings/part3
  905.     /pub/usenet/news.answers/periodic-postings/part4
  906.     /pub/usenet/news.answers/periodic-postings/part5
  907.     /pub/usenet/news.answers/periodic-postings/part6
  908.     /pub/usenet/news.answers/periodic-postings/part7
  909.     /pub/usenet/news.answers/periodic-postings/part8
  910.     /pub/usenet/news.answers/periodic-postings/part9
  911.  
  912.    They are also available from mail-server@rtfm.mit.edu by sending a
  913.    mail message containing any or all of:
  914.  
  915.     send usenet/news.answers/periodic-postings/part1
  916.     send usenet/news.answers/periodic-postings/part2
  917.     send usenet/news.answers/periodic-postings/part3
  918.     send usenet/news.answers/periodic-postings/part4
  919.     send usenet/news.answers/periodic-postings/part5
  920.     send usenet/news.answers/periodic-postings/part6
  921.     send usenet/news.answers/periodic-postings/part7
  922.     send usenet/news.answers/periodic-postings/part8
  923.     send usenet/news.answers/periodic-postings/part9
  924.  
  925.    If you want to find out more about the mail server, send a message
  926.    to it containing "help".
  927.  
  928. -- 
  929.                 pshuang@mit.edu (Ping Huang)
  930.                 jik@cam.ov.com (Jonathan I. Kamens)
  931.                 ig25@rz.uni-karlsruhe.de (Thomas Koenig)
  932.                 buglady@bronze.lcs.mit.edu (Aliza R. Panitz)
  933.  
  934.                         -- the *.answers moderation team
  935.  
  936.  
  937.